home *** CD-ROM | disk | FTP | other *** search
/ IRIX Installation Tools & Overlays 1999 May / SGI IRIX Installation Tools & Overlays 1999 May - Disc 2.iso / relnotes / dmedia_dev / ch07.z / ch07
Text File  |  1999-04-19  |  8KB  |  265 lines

  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        7.  _V_i_d_e_o__L_i_b_r_a_r_y
  9.  
  10.        This chapter lists information about the video developer
  11.        subsystem included in the IRIS Digital Media Development
  12.        Environment.  It includes known problems and workarounds.
  13.  
  14.        The Silicon Graphics Video Library is a device independent
  15.        library for video devices on Silicon Graphics workstations
  16.        equipped with video hardware.  The VL development
  17.        environment supports the built in video in Indy systems,
  18.        Galileo Video , IndigoVideo, Power IndigoVideo, Indy
  19.        Video, and Sirius Video.  Future releases will support
  20.        additional video devices.
  21.  
  22.        The execution environment for video includes a control
  23.        panel, _v_i_d_e_o_p_a_n_e_l, that can be launched from the Icon
  24.        Catalog, as well as _v_i_d_e_o_i_n, an application that displays
  25.        video in a window on the screen.  For hardware devices that
  26.        support video output capabilities, the execution environment
  27.        also includes _v_i_d_e_o_o_u_t, an application that allows you to
  28.        select a windowed area of the screen or the whole screen to
  29.        send to video output connectors.  There are also two command
  30.        line applications, _v_i_d_t_o_m_e_m and _m_e_m_t_o_v_i_d, that support frame
  31.        in from and out to video.  Documentation of these tools is
  32.        included in the Utilities Guide.
  33.  
  34.        For additional information about the Video Library see the
  35.        overview man page _V_L_i_n_t_r_o(3dm)
  36.  
  37.  
  38.        7.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  39.  
  40.        This section lists changes and additions to the video
  41.        subsystem of the IRIS Digital Media Development Environment
  42.        since the IRIX 5.3 release.
  43.  
  44.           +o The vino device driver is now implemented as a loadable
  45.             kernel module (see mmmmllllooooaaaadddd((((4444))))).
  46.  
  47.           +o Additional functionality has been added to the Video
  48.             Library.  An ability to configure the connectivity of a
  49.             hardware device is provided by the vvvvllllSSSSeeeettttCCCCoooonnnnnnnneeeeccccttttiiiioooonnnn((((3333ddddmmmm))))
  50.             library function.  Video streams for some devices (e.g.
  51.             vvvviiiinnnnoooo((((7777))))) can be synchronized using the new Video
  52.             Library support for Unadjusted System Time and Media
  53.             Sequence Counters.  See the vvvviiiiddddeeeeoooossssyyyynnnncccc((((3333ddddmmmm)))) and
  54.             vvvvllllGGGGeeeettttUUUUSSSSTTTTMMMMSSSSCCCCPPPPaaaaiiiirrrr((((3333ddddmmmm)))) manual pages for further
  55.             information.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        7.2  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  75.  
  76.        This section lists some of the known problems with the Video
  77.        Library.
  78.  
  79.           +o When using vvvvllllSSSSeeeettttuuuuppppPPPPaaaatttthhhhssss((((,,,,,,,,,,,,,,,,VVVVLLLL____DDDDOOOONNNNEEEE____UUUUSSSSIIIINNNNGGGG)))) all controls
  80.             are cleared, and must be set again to begin using the
  81.             same path.  Similarly, when marking a path as
  82.             VL_READ_ONLY, the controls are also cleared and must be
  83.             set again before using the path.
  84.  
  85.           +o The names of packing modes VL_PACKING_RGBA and
  86.             VL_PACKING_RGBA_8 do not reflect the true order in
  87.             which data is laid out in memory.  It in fact is,
  88.             ABGR_8 which is what IrisGL uses directly for
  89.             lrectwrite.
  90.  
  91.           +o If you change from an NTSC to a PAL source you may need
  92.             to restart any running video applications for them to
  93.             display correct video data.
  94.  
  95.           +o VLStreamAvailable events are not implemented.
  96.  
  97.           +o For certain monitors and timings you may want to use
  98.             the _s_e_t_m_o_n command. See the man page for details.
  99.  
  100.           +o The Video Library dynamically loads video modules using
  101.             _d_l_o_p_e_n(3).  There may be limitations in using _p_i_x_i_e(1)
  102.             to instrument a library loaded by _d_l_o_p_e_n.
  103.  
  104.  
  105.        7.3  _D_o_c_u_m_e_n_t_a_t_i_o_n__E_r_r_o_r_s
  106.  
  107.           +o It may not be clearly explained everywhere in the
  108.             documentation that a buffer contains a single item
  109.             where an item is either a field of a frame depending an
  110.             VL_CAP_TYPE.
  111.  
  112.           +o When using an IrisGL window in combination with a
  113.             screen drain, the value VL_IRISGLWINDOW must be
  114.             specified rather than the GL window id. After setting
  115.             the control, gconfig() must be called.
  116.  
  117.           +o The definition of VLControlValue is a union that
  118.             includes stringVal[96] which is only supported on
  119.             Sirius Video.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        7.4  _I_n_d_y__V_I_N_O__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  141.  
  142.           +o The first frame of interleaved video data captured by
  143.             the vino device after a call to vlBeginTransfer may
  144.             contain one black field.  That is, every other line of
  145.             the interleaved video frame may be black.  This error
  146.             can only occur when VL_CAP_TYPE is equal to
  147.             VL_CAPTURE_INTERLEAVED.  An application may workaround
  148.             this problem by ignoring the first frame in an
  149.             interleaved capture, or by continually recapturing a
  150.             single interleaved frame until it detects that every
  151.             other line is not black.
  152.  
  153.           +o When attempting to capture frames using a vino device
  154.             with the VL packing set to VL_PACKING_RGBA_8 or
  155.             VL_PACKING_RGB_8, if the number of lines of video
  156.             desired is a value of (8 * n - 1) for n = 2 to 60, the
  157.             capture will not be started successfully, and the
  158.             application will never receive the first buffer of
  159.             video data.  The application may workaround this
  160.             problem by not requesting the number of lines of video
  161.             to be one of these values.
  162.  
  163.           +o Setting VL_RATE to lower than 5 does not work.  The
  164.             application can work around this by pausing between
  165.             captures.
  166.  
  167.           +o VINO does not perform clipping from the right side.  If
  168.             you specify a clip, the clipping will be taken from the
  169.             left.  The application must workaround this in
  170.             software.
  171.  
  172.           +o Zooms of 1/4, 1/6, 1/8 use software for part of the
  173.             decimation.
  174.  
  175.           +o Zooms of 1/5, 1/7, 1/8 may display some green color
  176.             shift.
  177.  
  178.  
  179.        7.5  _G_a_l_i_l_e_o__V_i_d_e_o__a_n_d__I_n_d_y__V_i_d_e_o__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  180.  
  181.           +o When using a VL_SCREEN node, after a VLEndTransfer,
  182.             there is no valid data displayed on the screen, so the
  183.             application should unmap the window.
  184.  
  185.           +o Galileo does not perform clipping int the x direction.
  186.             The application must workaround this in software.
  187.  
  188.           +o The following input controls are valid on Galileo Video
  189.             but are not valid on Indy Video:  Bottom Flutter,
  190.             Chroma Delay, Peak White, U Gain Coarse, V Gain Coarse,
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.             U Gain Fine, V Gain Fine.  The following output
  207.             controls are valid on Galileo Video but are not valid
  208.             on Indy Video:  Sync Level, UV Level, RGB Gain, Y/C
  209.             Gain, C Gain.
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.